Skip to content

feat(profiles): add Valve Steam Deck gamepad - #89

Draft
ReenigneArcher wants to merge 6 commits into
masterfrom
feat/steam-controller
Draft

feat(profiles): add Valve Steam Deck gamepad#89
ReenigneArcher wants to merge 6 commits into
masterfrom
feat/steam-controller

Conversation

@ReenigneArcher

@ReenigneArcher ReenigneArcher commented Aug 17, 2026

Copy link
Copy Markdown
Member

Description

Introduces a native Steam Deck controller profile (VID 0x28DE, PID 0x1205) across all supported backends:

  • New GamepadProfileKind::steam_deck enum value and profiles::steam_deck() factory
  • 64-byte vendor HID descriptor, native state packet packing (buttons, sticks, triggers, touch, motion)
  • SteamDeckFeatureReportState shared helper for feature-report initialization (serial query, desktop-mapping commands, rumble via 0xEB)
  • Linux uhid backend: 4 ms periodic reports, SET/GET feature handling, serial seeding from stable_id
  • Windows backend: periodic state re-submission thread, feature-report responder, VHF queue dedup on button bytes
  • FreeBSD uses uinput path for Steam Deck (same as Xbox/Switch)
  • Four rear paddles (L4/R4/L5/R5) exposed via supported_rear_paddle_count = 4, Quick Access mapped to misc1
  • Protocol constant LVH_WINDOWS_GAMEPAD_STEAM_DECK = 7, broker validation updated
  • Full unit and consumer tests on Linux, Windows, and FreeBSD backends

Screenshot

Issues Fixed or Closed

Roadmap Issues

Type of Change

  • feat: New feature (non-breaking change which adds functionality)
  • fix: Bug fix (non-breaking change which fixes an issue)
  • docs: Documentation only changes
  • style: Changes that do not affect the meaning of the code (white-space, formatting, missing semicolons, etc.)
  • refactor: Code change that neither fixes a bug nor adds a feature
  • perf: Code change that improves performance
  • test: Adding missing tests or correcting existing tests
  • build: Changes that affect the build system or external dependencies
  • ci: Changes to CI configuration files and scripts
  • chore: Other changes that don't modify src or test files
  • revert: Reverts a previous commit
  • BREAKING CHANGE: Introduces a breaking change (can be combined with any type above)

Checklist

  • Code follows the style guidelines of this project
  • Code has been self-reviewed
  • Code has been commented, particularly in hard-to-understand areas
  • Code docstring/documentation-blocks for new or existing methods/components have been added or updated
  • Unit tests have been added or updated for any new or modified functionality

AI Usage

See our AI usage policy.

  • None: No AI tools were used in creating this PR
  • Light: AI provided minor assistance (formatting, simple suggestions)
  • Moderate: AI helped with code generation or debugging specific parts
  • Heavy: AI generated most or all of the code changes

@codecov

codecov Bot commented Aug 17, 2026

Copy link
Copy Markdown

❌ 1 Tests Failed:

Tests completed Failed Passed Skipped
202 1 201 2
View the top 1 failed test(s) by shortest run time
LinuxConsumerTest::SdlSeesSteamDeckCanonicalButtonsAndRumble
Stack Traces | 3.04s run time
.../tests/unit/test_linux_consumers.cpp:530
Expected: (joystick_index) >= (0), actual: -1 vs 0

To view more test analytics, go to the Test Analytics Dashboard
📋 Got 3 mins? Take this short survey to help us improve Test Analytics.

Introduces a native Steam Deck controller profile (VID 0x28DE, PID 0x1205) across all supported backends:

- New `GamepadProfileKind::steam_deck` enum value and `profiles::steam_deck()` factory
- 64-byte vendor HID descriptor, native state packet packing (buttons, sticks, triggers, touch, motion)
- `SteamDeckFeatureReportState` shared helper for feature-report initialization (serial query, desktop-mapping commands, rumble via `0xEB`)
- Linux uhid backend: 4 ms periodic reports, SET/GET feature handling, serial seeding from stable_id
- Windows backend: periodic state re-submission thread, feature-report responder, VHF queue dedup on button bytes
- FreeBSD uses uinput path for Steam Deck (same as Xbox/Switch)
- Four rear paddles (L4/R4/L5/R5) exposed via `supported_rear_paddle_count = 4`, Quick Access mapped to `misc1`
- Protocol constant `LVH_WINDOWS_GAMEPAD_STEAM_DECK = 7`, broker validation updated
- Full unit and consumer tests on Linux, Windows, and FreeBSD backends
@sonarqubecloud

Copy link
Copy Markdown

Quality Gate Failed Quality Gate failed

Failed conditions
5 New issues
5 New Code Smells (required ≤ 0)

See analysis details on SonarQube Cloud

Catch issues before they fail your Quality Gate with our IDE extension SonarQube for IDE

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant